***************************************************************************
***                            #QuizPL TeaM                             ***
***                                                                     ***
***                  Najlepszy kanał quizowy na IRC-u!                  ***
***************************************************************************
***                       https://www.quizpl.net                        ***
***                         kontakt@quizpl.net                          ***
***************************************************************************

Witaj drogi Quizowiczu. Oto instrukcja, dzięki której będziesz mógł/mogła samodzielnie napisać i puścić swoją premierę 
quizową na kanale #QuizPL. :)

Pełny poradnik znajdziesz pod adresem: https://www.quizpl.net/poradnik

############################
### I. Instalacja mIRCa. ###
############################

Jeśli masz już ściągniętego i poprawnie skonfigurowanego mIRCa możesz pominąć ten punkt i po uruchomieniu mIRCa dodać 
do ulubionych kanał #QuizPL oraz wejść na kanał poleceniem /join #QuizPL


Aby zaś ściągnąć mIRCa i móc grać na kanale #QuizPL wykonaj poniższe kroki:

1. Ściągnij plik https://www.quizpl.net/viewforum.php?f=79
2. Rozpakuj powyższy plik do dowolnego katalogu, np. C:\Program Files\
3. Przeczytaj zamieszczony tam plik "-= Przeczytaj mnie =-.txt"
4. Uruchom plik mIRC.exe
5. Kliknij teraz na pierwszą ikonkę pod menu (tą z piorunkiem) lub wpisz na dole "/server polska.irc.pl" (bez 
   cudzysłowu) i wciśnij enter. Jeśli połączyłeś się z serwerem i automatycznie otworzyło się nowe okienko, to jesteś 
   już na kanale #QuizPL i od teraz możesz zdobywać punkciki!


Alternatywnie możesz ściągnąć mIRCa ze strony autora programu https://www.mirc.com/get.html lecz wówczas musisz 
samodzielnie skonfigurować program lub napisać na adres kontakt@quizpl.net by uzyskać naszą pomoc.

###############################
### II. Instalacja skryptu. ###
###############################

Rozpakuj to archiwum i przenieś wszystkie pliki do głównego katalogu mIRCa, np. C:\Program Files\mIRC\ oraz uruchom 
plik mirc.exe

Teraz, by móc korzystać ze skryptu (w dniu puszczania quizu), należy go wgrać do uruchomionego wcześniej mIRCa. 
Uzyskasz to poleceniem:

/load -rs oquiz.als

W okienku statusu powinien pojawić się podobny do tego napis:

* Loaded script 'C:\...\oquiz.als'

#############################################
### III. Przygotowanie pliku z pytaniami. ###
#############################################

Ten rodzaj quizu opiera się typowo na wiedzy graczy i jest podstawową formą premier quizowych.

Gdy zdecydujesz się napisać swój quiz i puścić go na kanale - wybierz sobie dziedzinę z jakiej chciałbyś napisać quiz 
(może być także wiedza ogólna).

Plik z pytaniami musi być w odpowiedniej postaci. Format pliku polega na tym, że pytania i odpowiedzi są umieszczane 
naprzemiennie w kolejnych linijkach zakończonych enterem, przy czym pytanie poprzedzamy "pyt ", zaś odpowiedź "odp " 
(zwróć uwagę czy przypadkiem nie napisałeś "pty" lub "opd", bo skrypt utknie na tym pytaniu). Przykład:

pyt Najlepszy kanał quizowy na IRC-u?
odp #QuizPL
pyt Ile jest 2*2?
odp cztery
pyt Jak ma na imie brat Lolka?
odp Bolek

Przykładowy quiz znajdziesz w pliku "przyklad.txt", zaznajom się z nim.


Podstawowe zasady układania quizów:

- format pliku musi być poprawny, bo quiz utknie na błędnym pytaniu (unikaj zbędnych spacji i wystrzegaj się pustych 
  linii)
- nie używaj w pytaniach i odpowiedziach znaków diakrytycznych (ą, ć, ę, ł, ń, ó, ś, ź, ż)
- pytania i odpowiedzi nie mogą zawierać błędów ortograficznych, stylistycznych, interpunkcyjnych i merytorycznych
- pytania zaczynaj wielką literą, a odpowiedzi małą, chyba że są to nazwy własne
- pytania nie mogą być ze sobą powiązane:

tak jest źle:

pyt Zagral glowna role w filmie "Szklana pulapka".
odp Bruce Willis
pyt Kto jest jego zona?
odp Demi Moore

tak jest dobrze:

pyt Zagral glowna role w filmie "Szklana pulapka".
odp Bruce Willis
pyt Byla zona Bruce'a Willisa.
odp Demi Moore

a tak nawet lepiej:

pyt Odtworca glownej roli w filmach "Szklana pulapka" oraz "12 malp".
odp Bruce Willis
pyt Byla zona Bruce'a Willisa (1987-1998).
odp Demi Moore

- unikaj długich odpowiedzi, najlepiej niech mają góra 2-3 wyrazy
- nie pisz zbyt długich, opisowych pytań - skonkretyzuj je
- nie używaj słów niecenzuralnych, jeśli to cytat z filmu lub piosenki użyj gwiazdki ("*") do cenzury
- nie układaj pytań "killerów", czyli takich, na które odpowiedzi znać będą tylko pasjonaci


Gdy już utworzysz zestaw ok. 50 pytań (na przykład w windowsowym notatniku, ale nie w Wordzie!), to zapisz je w pliku, 
w głównym katalogu z mIRCem. Pamiętaj jednak by nazwa pliku nie zawierała spacji.

################################
### IV. Puszczenie premiery. ###
################################

Kiedy napiszesz już quiz i ustalisz z operatorami kanału dzień i godzinę premiery - możesz przystąpić do jej 
realizacji w wyznaczonym terminie. Nie zapomnij tylko o wgraniu skryptu (patrz punkt II). ;)

Aby uruchomić quiz otwórz okno kanału #QuizPL i wpisz:

/start #QuizPL

Uwaga, plik z pytaniami wybieramy dopiero po otworzeniu się odpowiedniego okienka, po wydaniu powyższego polecenia.

W razie potrzeby możesz zwiększyć opóźnienie między poszczególnymi pytaniami (domyślnie jest to 5 sekund) poleceniem: 
/delay 10

*** Teraz gracze grają i cieszą się z Twojej premiery. ;) ***

Po zakończeniu premiery trzeba wyświetlić wyniki. Uczynisz to poniższymi poleceniami:

Punktacja standardowa:

/rank

Punktacja AntyGooglowa (liczba odpowiedzi przed pierwszą podpowiedzią):

/ranking

Najlepsze czasy odpowiadania:

/czas

Na koniec zamykasz quiz poleceniem:

/koniec


Po zakończeniu i zamknięciu quizu możesz (zalecane), ale nie musisz wyładować skrypt z mIRCa. Dokonasz tego 
poleceniem:

/unload -rs oquiz.als

Aby puścić kolejną premierkę należy ponownie wgrać skrypt poleceniem /load (patrz punkt II).


Uwaga, nie zapomnij by po zakończeniu premiery przysłać plik z pytaniami, temat quizu wraz z datą puszczenia oraz 
pełne wyniki na adres kanałowy: kontakt@quizpl.net Pytania zostaną wówczas dodane do bazy naszego quizbota i wszyscy 
będą mogli się nimi cieszyć jeszcze przez długie lata ;)

##############################
### V. Polecenia kanałowe. ###
##############################

W trakcie trwania premiery quizowej dla graczy dostępne są specjalne polecenia. Pamiętaj, że z uwagi na specyficzny 
sposób funkcjonowania mIRCa te polecenia nie są dostępne dla puszczającego premierę.

Wyświetlenie punktacji najlepszych graczy: !stat

#################################
### VI. Informacje dodatkowe. ###
#################################

Skrypt ten jest rozszerzoną wersją standardowego dizzy o limitowany czas na odpowiedzi, automatyczne podpowiedzi i 
dodatkowe punkty za szybkie odpowiedzi, tak aby ograniczyć "googlowanie" graczy. W efekcie quizy tego typu są 
błyskawiczne.

###################################
### VII. Informacje o skrypcie. ###
###################################

Wersja: AntyGoogler
Autor: oyey
Rozbudowa: wilk (wyświetlanie punktów z podpowiedziami, drobne korekty)

Miłej zabawy życzy,
Ekipa #QuizPL.
